====== Serveur de calendrier CalDAV : DAVICAL ======

DAViCal est un serveur d'agenda partagé. C'est une implémentation du protocole CalDAV qui est conçu pour le stockage d'agenda (au format iCalendar) sur un serveur partagé à distance.

Un nombre croissant de gestionnaire d'agenda supporte le protocole CalDAV, par exemple Mozilla Calendar (Sunbird / Lightning), Evolution, Mulberry, Chandler, Rainlendar Pro et divers autres produits propriétaire tels que Apple iCal et iPhone. 

===== Installation ======

Davical a été integré au dépôt à partir de jaunty, pour l'installer: apt://davical

===== Configuration ======

==== Configuration de postgresql =====

Davical utilise une base de données sql, sous postgresql.

Pour se connecter à postgres:

   sudo -u postgres psql postgres

création du mot de passe administrateur de postgresql:
   \password postgres

- saisir le mot de passe, puis taper \q pour sortir de la console postgres

- [[http://doc.ubuntu-fr.org/postgresql#creer_un_utilisateur_postgresql|creez les utilisateurs]] davical_dba et davical_app dans postgresql.


- éditer le fichier /etc/postgresql/8.3/main/pg_hba.conf pour ajouter au début ce qui suit:

   local all all trust
   local davical davical_dba trust
   local davical davical_app trust
   host davical davical_app 127.0.0.1/32 trust

<note>si vous utilisez une DB (Base de données) distante, à la dernière ligne remplacez 127.0.0.1/32 par l'IP/masque du serveur Davical.</note>

Redémarrer postgresql
   sudo /etc/init.d/postgresql-8.3 reload

Nous allons maintenant peupler la DB grace au script fourni par davical:
   sudo su postgres -c /usr/share/davical/dba/create-database.sh

<note important>Une fois le script terminé, le mot de passe admin s'affiche, pensez à le noter, il sera indispensable par la suite</note>

il faut maintenant retourner dans le fichier /etc/postgresql/8.3/main/pg_hba.conf pour en retirer la ligne:
   local all all trust
<note important>dans le cas contraire, n'importe qui aura tout les droits sur toutes les bases!!!</note>

enfin redémarrer postgresql:
   sudo /etc/init.d/postgresql-8.3 reload

==== Configuration d'apache =====

[[http://doc.ubuntu-fr.org/tutoriel/virtualhosts_avec_apache2|Creez un vhost]] avec le paramètre " DocumentRoot /usr/share/davical/htdocs "

ajoutez aussi avant la ligne </VirtualHost> ce qui suit:

    php_value include_path /usr/share/awl/inc
    php_value magic_quotes_gpc 0
    php_value register_globals 0
    php_value open_basedir 1
    php_value error_reporting "E_ALL & ~E_NOTICE"
    php_value default_charset "utf-8"

<note>Pensez à activer le vhost</note>

==== Configuration de Davical =====

créer le fichier /etc/davical/davical-conf.php et copier ça dedans:

   <?php
   //  $c->domain_name = "mydavicalsite.dyndns.org";
   //  $c->sysabbr     = 'rscds';
     $c->admin_email = 'admin@example.net';
     $c->system_name = "Really Simple CalDAV Store";
   //  $c->collections_always_exist = true;
   //  $c->enable_row_linking = true;
     $c->default_locale = en_US.UTF-8;
     $c->pg_connect[] = 'dbname=davical port=5432 user=davical_app';


créer un lien symbolique de ce dernier vers /etc/davical/nom_de_domaine-conf.php

A ce stade, vous pouvez accéder à l'interface web de Davical en tapant http:\\localhost dans le navigateur.

pour vous identifier utilisez le mot de passe généré automatiquement après le script /usr/share/davical/dba/create-database.sh executé précédemment avec le login admin.

===== Utilisation de Davical ======

Pour commencer, il faut créer un utilisateur à partir de l'interface d'administration de Davical (l'outil est tellement simple à utiliser que je n'entrerai pas dans les détails...)

Une fois l'utilisateur créé, rendez-vous dans votre agenda préféré, au moment de saisir l'url tapez: http://serveur_caldav/caldav.php/username/home

il faut bien sûr remplacer serveur_caldav et username...

Document inspiré du [[http://wiki.davical.org/w/Ubuntu_Jaunty|wiki Davical]] testé par mes soins.

// Contributeurs : wouldsmina